home *** CD-ROM | disk | FTP | other *** search
/ MacUser Mac Bin 28 / MACUSER-MACBIN28A-1996-03.ISO.7z / MACUSER-MACBIN28A-1996-03.ISO / Demo / MachTen 4.0.2 Demo / X Window Software / X11R5 / man / mann / mkfontdir.0 < prev    next >
Text File  |  1995-06-30  |  3KB  |  127 lines
  1. NAME
  2.        mkfontdir  -  create fonts.dir file from directory of font
  3.        files
  4.  
  5. SYNOPSIS
  6.        mkfontdir [directory-names]
  7.  
  8. DESCRIPTION
  9.        Mkfontdir For each directory argument, mkfontdir reads all
  10.        of  the  font files in the directory searching for proper-
  11.        ties named "FONT", or (failing that) the name of the  file
  12.        stripped  of  its  suffix.   These are used as font names,
  13.        which are written out  to  the  file  "fonts.dir"  in  the
  14.        directory along with the name of the font file.
  15.  
  16.        The  kinds of font files read by mkfontdir depends on con-
  17.        figuration parameters, but typically include  PCF  (suffix
  18.        ".pcf"),  SNF (suffix ".snf") and BDF (suffix ".bdf").  If
  19.        a font exists in multiple formats,  mkfontdir  will  first
  20.        choose PCF, then SNF and finally BDF.
  21.  
  22. SCALABLE FONTS
  23.        Because  scalable  font files do not usually include the X
  24.        font name, the fonts.dir file  in  directories  containing
  25.        such fonts must be edited by hand to include the appropri-
  26.        ate entries for those fonts.  However, when  mkfontdir  is
  27.        run, all of those additions will be lost, so be careful.
  28.  
  29. FONT NAME ALIASES
  30.        The  file  "fonts.alias" which can be put in any directory
  31.        of the font-path is used to  map  new  names  to  existing
  32.        fonts,  and  should  be  edited  by  hand.   The format is
  33.        straight  forward  enough,   two   white-space   separated
  34.        columns,  the first containing aliases and the second con-
  35.        taining font-name patterns.
  36.  
  37.        When a font alias is  used,  the  name  it  references  is
  38.        search for in the normal manner, looking through each font
  39.        directory in turn.  This means that the aliases  need  not
  40.        mention fonts in the same directory as the alias file.
  41.  
  42.        To  embed  white-space in either name, simply enclose them
  43.        in double-quote marks, to embed double-quote marks (or any
  44.        other character), precede them with back-slash:
  45.  
  46.        "magic-alias with spaces"     "¥"font¥name¥" with quotes"
  47.        regular-alias            fixed
  48.  
  49.        If the string "FILE_NAMES_ALIASES" stands alone on a line,
  50.        each file-name in the directory (stripped of it's  suffix)
  51.        will be used as an alias for that font.
  52.  
  53. USAGE
  54.        Both the X server and the Font Server look for "fonts.dir"
  55.  
  56.  
  57.  
  58. X Version 11                Release 5                           1
  59.  
  60.  
  61.  
  62.  
  63.  
  64. MKFONTDIR(1)                                         MKFONTDIR(1)
  65.  
  66.  
  67.        and "fonts.alias" files in each directory in the font path
  68.        each time it is set (see xset(1)).
  69.  
  70. SEE ALSO
  71.        X(1), Xserver(1), fs(1), xset(1)
  72.  
  73.  
  74.  
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124. X Version 11                Release 5                           2
  125.  
  126.  
  127.